入门指南（Getting Started）
在您选择的平台上运行 Rive。
Rive 运行时是开源库，允许您在应用程序、游戏和网站中加载和控制动画。深入了解每个子页面以开始使用！
如何使用本指南
在本节中，您将找到运行时子页面，这些页面提供了在您选择的平台上开始使用所需的所有信息和资源。请参阅下面的安装和入门。
您还将找到专门用于在运行时控制动画的页面。例如，更新状态机输入或文本运行。请参阅下面的动画控制和交互。
安装和入门（Installation and Getting Started）
请务必查看每个运行时部分下提供的其他文档。这些文档提供了特定平台的注意事项、迁移指南和高级使用信息。
- Web (JS) 运行时
- 本指南介绍如何开始使用 Web 运行时库。
- React 运行时
- 本指南介绍如何开始使用 React 运行时库。
- React Native 运行时
- 本指南介绍如何开始使用 React Native 运行时库。
- iOS/macOS 运行时
- 本指南介绍如何开始使用 iOS/macOS 运行时库。
- Android
- 本指南介绍如何开始使用 Android 运行时库。
- Flutter 运行时
- 本指南介绍如何开始使用 Flutter 运行时库。
- Unity
- 本指南介绍如何开始使用 Unity 运行时库。
- Bevy
- 本指南介绍如何开始使用 Bevy 运行时库。
- Unreal
- 本指南介绍如何开始使用 Unreal 运行时库。
动画控制和交互（Animation Control and Interaction）
这些部分提供了有关如何在运行时与 Rive 动画交互的详细信息。在这里，您将找到所有 Rive 官方运行时的文档和代码示例。
- 动画播放
- 配置运行时动画播放属性。
- 布局
- 在运行时控制 Rive 图形的布局（适配和对齐）。
- 状态机
- 从运行时与 Rive 状态机交互。
- 文本
- 在运行时更新 Rive 文本。
- 播放音频
- 运行时音频属性和控制。
- Rive 事件
- 在运行时订阅 Rive 事件。
- 加载资源
- 在运行时动态加载和替换资源（图像、字体、音频）。
- 缓存 Rive 文件
- 在多个 Rive 实例之间缓存和重用 Rive 文件对象。
其他部分（Other Sections）
版本控制（Versioning）
随着我们发布 Rive 编辑器的更新，我们偶尔会推送更新的运行时以支持新功能。请参阅功能支持了解特定功能所需的最低运行时版本。
在大多数情况下，最新的运行时也将支持您的 Rive 资源的先前版本，因此您无需重新导出资源即可更新到最新的运行时。
在需要重新导出以利用最新功能的情况下，有多种方法可以导出您的 Rive 文件。查看我们关于导出的文档以了解更多信息。
官方运行时（Official Runtimes）
查看运行时子页面了解如何开始使用！
| 平台 | 安装指南 |
|---|---|
| Web | Web 运行时 |
| iOS | iOS 运行时 |
| Android | Android 运行时 |
| Flutter | Flutter 运行时 |
| React Native | React Native 运行时 |
| C++ | C++ 运行时 |
社区运行时（Community Runtimes）
| 运行时 | 作者 | 链接 |
|---|---|---|
| Vue.js | Dan Nelson | GitHub |
| Angular | François Guezengar | GitHub |
| QtQuick | basysKom | Github |
| AWTK | Li XianJing | GitHub |
处理 .riv 文件（Handling .riv Files）
当使用 Git 提交 .riv 文件时，请考虑添加一个 .gitattributes 文件并将 .riv 文件标记为 binary 文件，以防止 Git 在这些文件被提交时更改行尾。否则，某些平台可能会在有换行符的地方意外损坏 .riv 文件（即 Windows CRLF 行尾与 LF 行尾），并在运行时读取文件时导致问题。
.gitattributes
*.riv binary
许可（Licensing）
我们的官方运行时都是开源的，并根据 MIT 许可证授权。您可以免费将它们用于个人和商业应用。
贡献（Contributing）
由于所有运行时都是开源的，我们鼓励您深入研究并四处查看！如果您发现缺少什么或觉得可以改进它，那就分叉它吧！